﻿               EPSON JavaPOS ADK 1.13.7版本  发行说明
                                                       精工爱普生公司
                                                               2012年12月27日

1. 概述
    EPSON JavaPOS ADK 1.13.7版本已被发行。使用该发行，您可以开发与UnifiedPOS
    规格1.13版本兼容的应用程序。

    本发行说明包含多个软件包的相关信息。
     - EPSON JavaPOS ADK 1.13.7 标准安装
     - EPSON JavaPOS ADK 1.13.7 仅限TM-T88V安装
     - EPSON JavaPOS ADK 1.13.7 仅限TM-T20安装
     - EPSON JavaPOS ADK 1.13.7 仅限TM-T81安装
     - EPSON JavaPOS ADK 1.13.7 仅限TM-T82安装
     - EPSON JavaPOS ADK 1.13.7 仅限TM-T81II安装
     - EPSON JavaPOS ADK 1.13.7 仅限TM-T82II安装

2. 已确认的操作环境
    EPSON JavaPOS ADK的操作在以下环境中已确认。
  (1) OS (操作系统)
     Windows 2000 Professional SP4 (32位)
     Windows XP Professional SP3 (32位)
     Windows Vista SP2 (32位/64位)
     Windows Server 2008 R2 (64位)
     Windows 7 SP1 (32位/64位)
     Windows 8 (32位/64位)
     Windows Server 2008 R2 SP1 (64位)
     Windows Embedded Standard (32位)
     Windows Embedded Standard 7 (32位/64位)
     Red Hat Enterprise Linux 6.1 (32位/64位)
     SuSE Linux Enterprise 11.1 (32位/64位)
     CentOS Linux 6.0 (32位/64位)
     Ubuntu 9.04 (32位/64位)
  (2) Java 操作环境
     Java Standard Edition 6 Update 26
      http://www.oracle.com/technetwork/java/javase/overview/index-jsp-136246.html
  (3) 图像处理API
     Java Advanced Imaging 1.1.3
      http://java.sun.com/products/java-media/jai/
  (4) libusb (Linux only)
     libusb-1.0-0_1.0.8-2_i386.deb(Ubuntu 32位)
      http://pkgs.org/ubuntu-10.10/ubuntu-main-i386/libusb-1.0-0_1.0.8-2_i386.deb.html
     libusb-1.0-0_1.0.8-2_amd64.deb(Ubuntu 64位)
      http://pkgs.org/ubuntu-11.04/ubuntu-main-amd64/libusb-1.0-0_1.0.8-2_amd64.deb.html
     libusb-1_0-0-1.0.8-4.1.i586.rpm(Other 32位)
      http://download.opensuse.org/distribution/11.4/repo/oss/suse/i586/
     libusb-1_0-0-1.0.8-4.1.x86_64.rpm(Other 64位)
      http://download.opensuse.org/distribution/11.4/repo/oss/suse/x86_64/


3. 安装与卸载
    请遵照“EPSON JavaPOS ADK 安装指南”中的步骤进行安装与卸载。

    注意在文件安装期间取消或突然终止安装程序可能使系统处于无法完成进一步安装的
    状态。为了在这种情况下安装JavaPOS，请使用“强制卸载”选项，然后再次运行
    安装程序。如果当使用“强制卸载”选项时，该进程被取消，系统可能仍然处于无法
    完成进一步重新安装的状态。在这种情况下，请再次使用“强制卸载”选项。

    当在以前安装过JavaPOS的系统上运行该安装程序时，在同一位置进行安装是必要的。
    如果JavaPOS被安装到不同的位置，之前的设置可能会抑制正确的操作。在这种情况
    下为了将JavaPOS安装到不同的位置，在运行该安装程序之前请使用“强制卸载”选
    项来清除所有之前的设置。


4. JavaPOS 1.13.3 安装
4.1 所支持的设备与已确认的固件版本
    有关详情请参考“SupportedDevicesList.txt”。

4.2 特别说明
4.2.1 示例程序
      - 当您使用该示例程序时，登录ID需要的是管理员帐户组。
      - 使用逻辑设备名称注册。
          POSPrinter        : POSPrinter
          LineDisplay       : LineDisplay
          MICR              : MICR
          CheckScanner      : CheckScanner
          CashDrawer        : CashDrawer
          MSR               : MSR
          Keylock           : Keylock
          ElectronicJournal : ElectronicJournal
      - 该示例程序显示一个(多个)控制方法的示例。
        因此，不保证所有设备的所有设置均能正确操作。

4.2.2 安装与卸载
      - 当安装该软件时，请在以下目录中创建一个名为“epson\pos”的目录。

      Windows
         Windows 2000/XP/Embedded:
          <System Drive>:\Documents and Settings\All Users
         Windows Vista/2008 Server/Windows 7:
          <System Drive>:\Program Files
      Linux
         /var

      DeviceService操作所要求的临时文件与信息文件保存在该“epson\pos”目录中。
      不要删除该目录。

      - 如果您选择“自定义”为安装类型并执行安装，不要为一个快捷文件夹指定根目
        录(“/”)。快捷文件夹将不被创建。(仅限Linux)

      - 关于安装，当“msvcr71.dll”文件在\WINDOWS\System32\目录中被复制
        或更新时，或者如果由安装程序进行安装的文件在安装时正在使用，则需要
        重新启动。

      - 关于卸载，由卸载程序进行卸载的文件在卸载时正在使用，则需要重新启动。

      - 可以同时执行安装程序与卸载程序，
        但是，该操作不被支持。(仅限Linux)

      - 在升级安装后，卸载程序有一个问题，即卸载程序无法删除所有安装目录。关于
        默认安装目录位置，在Linux系统上卸载程序无法删除“/opt/EpsonJavaPOS”
        目录；在Windows系统上卸载程序无法删除“C:\Program Files\Epson\JavaPOS”
        与“C:\Program Files\Epson”目录。在卸载完成后您可以手动删除这些目录。
        

      - 如果您选择“自定义”为安装类型并更改JavaPOS的服务的安装位置，您将无法
        从安装程序所创建的CheckHealth工具的快捷方式上启动CheckHealth工具。
        在这种情况下，请遵照以下说明更正快捷方式的基础Shell脚本(或批处理文件)。

      - Classpath设置
         JavaPOS服务的安装目录中的JAR文件，需要为CLASSPATH设置。

     - 在本产品的以前版本（1.11.20版本-1.13版本）上进行无提示覆盖安装时，
       请重新启动系统。

4.2.3 跟踪功能
      当使用跟踪(日志)功能时
       - 跟踪结果保存在以下目录中。

      Windows
         Windows 2000/XP/Embedded:
          <System Drive>:\Documents and Settings\All Users\EPSON\pos\tm\Trace
         Windows Vista/2008 Server/Windows 7:
          <System Drive>:\Program Files\EPSON\pos\tm\Trace
      Linux
         /var/epson/pos/trace

4.2.4 USB通信
       - 如果以下设备在SetupPOS注册中注册，则在“4.2.4.1 步骤”中配置设置。
           Windows: TM-H5000II/TM-H5200/TM-J2000/TM-J2100/TM-J7000/TM-J7100/
                    TM-J7500/TM-J7600
4.2.4.1 步骤
      1) 设置USB端口设置[端口名称类型]到[序列号]。
      2) 指定USB序列号作为端口名称。
 
      USB序列号是为USB独占提供的序列号。
      USB序列号可以用以下步骤检查。

      - 执行打印机自检打印。
        通常，如果在打印机盖板关闭并按下进纸开关的情况下，打开打印机电源，自检
        打印则在卷纸上执行。
      - 从打印结果中可以识别序列号。
        当打印结果为a)格式时，显示的“ID”部分为USB序列
        号(以下示例中YYYYYYYYYYYYYY即为序列号)。当打印结果为b)格式时，USB
        序列号与打印机序列号相同。 在这种情况下，检查打印机上所附的标签。

        a) 当打印USB序列号时
          ----------
              :
          Firmware Version X.XX ESC/POS

          Interface UB-UXXXX Ver.X.XX
           ID  :YYYYYYYYYYYYYY
              :
              :
          ----------

        b) 当不打印USB序列号时
          ----------
              :
          Firmware Version X.XX ESC/POS

          USB Interface or other
              :
              :
          ----------

        * 上述所示“USB Interface or other”可能简单地打印为“USB Interface”。

    注意当使用此方法设置设备时，使用不同的USB序列号更改设备时，需要更改
    SetupPOS的设置。

    注意在Linux上当使用序列号作为USB连接的端口名称类型时，
    需要在SetupPOS上仅输入序列号的前17个字符。

    如果当打开/关闭打印机时，显示“找到新的硬件向导”，则取消该向导并安装
    EPSON高级打印机驱动程序(4.50或更高版本)。(仅限Windows)

4.2.5 POSPrinter
       - 多色阶打印：
         由于多色阶打印要使用更多的打印数据，通过串行或Ethernet接口打印可
         能会变得不稳定，且打印结果会出现白色条纹。

4.2.6 Keylock
       - 使用Windows2000时的限制。
         DM-KX060的键盘锁定功能(为IR-700的一个可选键盘)不可用。
       - 尽管在DM-KX060手册中SetupPOS功能已被编档，
         但当前的SetupPOS并不包括该设置。
        “键位兼容性模式”将被设置为“UPOS规格”。

4.2.7 打印机电源打开时的状态送信
       - 在已经使用JavaPOS后，当打开打印机电源时，一些打印机被设置传送打印机
         状态的三个字节到主机。使用该状态以便在打印机电源打开时JavaPOS可以识
         别。

4.2.8 徽标实用程序(TMFlogo等)
       - 徽标实用程序不在该软件包中。要上载徽标数据到永久性内存，请使用
         setBitmap方法，或获取该徽标实用程序。

4.2.9 其他特别说明
       - 访问数据的权限(仅限Linux)
         要存储必要的信息，JavaPOS创建一个名为“/var/epson/pos”的目录。设置
         “/var/epson/pos”目录，所有子目录与所有文件的访问权限，
          以便使用JavaPOS的用户可以写入。

       - 当打印机处于使用状态时，如果计算机进入待机/休眠模式，驱动程序有可能
         变得不稳定，所以不支持待机/休眠模式。

       - 在SetupPOS上的拖放功能需要GTK 2.10.4或更高版本。

       - 当在SLED 11环境中通过一个终端启动SetupPOS时，将显示GTK-warning。
         但是，SetupPOS的操作将不受影响。

4.3 修订历史记录
    [1.13.7版本]
       - 已添加支持Windows 8 (32位)，Windows 8 (64位)，及Windows Server 2008
         R2 SP1 (64位)。
       - 已添加支持TM-T82II。
       - 已添加支持TM-T82II-42C。
    [1.13.6版本]
     (1)POSPrinter
       - 已添加支持TM-P60II。
    [1.13.3版本]
     短嗤延晒
    [1.13.2版本]
     (1)POSPrinter
       - TM-T81II的支持端口中追加了以太网。
    [1.13版本]
      (1)基于UPOS V1.12, V1.13版本的新功能如下所示
         POSPrinter：
            - 追加ESC指令功能
             ESC星号指令的功能
             删除线功能
            - 追加条码GS1，QR常数符号
      (2)SetupPOS
        - 改变USB接口的设置方法。
        - 该设备可以测试SetupPOS。
      (3)POS打印机（POSPrinter）
        - 追加了可通过DirectIOEvent通知ESC / POS命令的响应类型。
        - 取消了在非易失性内存（NVRAM）上注册图像数量的限制。

      特别说明:上述变化是以下类别和设备。
          类别：POSPrinter,MICR,CheckScanner,LineDisplay,CashDrawer
          设备：TM-H6000II/III/IV,TM-T20,TM-T70,TM-T88III/IV/V,
                TM-T90,TM-L90,TM-U220
    [1.11.20版本]
     (1) POSPrinter
       - 可以提供TM-T88V的自动纸张节约功能了。
    [1.11.18版本]
     (1) POSPrinter
       - TM-T20的支持端口中追加了以太网。
       - TM-T20-42C的支持端口中追加了以太网。
     (2) ElectronicJournal
       - TM-T20的支持端口中追加了以太网。
       - TM-T20-42C的支持端口中追加了以太网。
    [1.11.17版本]
     (1) POSPrinter
       仅安装JavaPOS 1.11.17 TM-T82:
        - 支持TM-T82型号南亚字符。
        - 支持TM-T82-42C型号南亚字符。
        - TM-T82的支持端口中追加了以太网。
        - TM-T82-42C的支持端口中追加了以太网。
    [1.11.16版本]
     (1) 通用
       - 已添加支持Windows 7 SP1 (32位)，Windows 7 SP1 (64位)，及Windows 
         Server 2008 R2 SP1 (64位)。
     (2) POSPrinter
       - TM-H6000IV多国语字符型号已被添加为被支持的设备。
    [1.11.15版本]
     (1) POSPrinter
       - 已添加支持TM-T82。
       - 已添加支持TM-T82-42C。
    [1.11.14版本]
     (1) 通用
       - 已添加支持Red Hat Enterprise Linux 5.3 (64位)。
       - 已添加支持SuSE Linux Enterprise 11 (64位)。
       - 已添加支持Windows Embedded Standard 7 (32位)。
       - 已添加支持Windows Embedded Standard 7 (64位)。
     (2) POSPrinter
       - 已添加支持TM-H6000IV。
       - 已添加支持TM-H2000。
       - 已添加支持TM-T81。
     (3) MICR
       - 已添加支持TM-H6000IV。
       - 已添加支持TM-H2000。
     (4) ElectronicJournal
       - 已添加支持TM-H6000IV。
    [1.11.13版本]
     (1) 通用
       - 已添加支持Windows Vista (64位)，Windows 7 (64位)，
         Windows Server 2008 R2 (64位)，Red Hat Enterprise Linux 5.3 (32位)，
         及SuSE Linux Enterprise 11 (32位)。
       - 已删除支持Red Hat Linux 9 (32位)，
         Red Hat Enterprise Linux 5 (32位)及SuSE Linux Enterprise 10 SP1 (32位)
     (2) POSPrinter
       - 已添加支持以串行连接的TM-T20。
       - 已添加支持以串行连接的TM-T20-42C。
     (3) ElectronicJournal
       - 已添加支持以串行连接的TM-T20。
       - 已添加支持以串行连接的TM-T20-42C。
    [1.11.12版本]
     (1) POSPrinter
       - 已添加支持TM-T88V(简体中文(GB18030)型号)。
       - 已添加支持TM-T88V(繁体中文型号)。
       - 已添加支持TM-T20。
       - 已添加支持TM-T20-42C。
       - 已添加多色阶打印功能。(仅限TM-T88V)
       - 已添加可选的外部蜂鸣器。(仅限TM-T88V)
       - 已添加一项设置以允许更改默认字符设置。(TM-T20)
       - 添加支持字符串打印的Unicode。(TM-T20)
     (2) ElectronicJournal
       - 已添加支持TM-T20。
       - 已添加支持TM-T20-42C。
    [1.11.11版本]
     (1) 通用
       - 已添加支持单位软件包。
       - 已添加支持Windows Server 2008 SP2，Windows Server 2008 R2，
         Windows Embedded Standard，与Windows 7。
     (2) POSPrinter
       - 已添加支持TM-T88V。
       - 已添加一项设置以允许更改默认字符设置。
         (仅限TM-T88V)
       - 添加支持字符串打印的Unicode。(仅限TM-T88V)
     (3) ElectronicJournal
       - 已添加支持TM-T88V。

